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NAME 

mlx5dv_get_clock_info - Get device clock information 

SYNOPSIS 

#include <infiniband/mlx5dv.h> 

int mlx5dv_get_clock_info(struct ibv_context *ctx_in, 
struct mlx5dv_clock_info *clock_info); 

DESCRIPTION 

Get the updated core clock Jnfo from the device driver. This information will be used later to translate the 
completion timestamp from HCA core clock to nanoseconds. The values of the clock are updated from the 
driver’s PTP clock, therefore, without a running PTP client on the machine, the wall clock conversion will 
not be accurate. 

Pass the latest struct mlx5dv_clock_info to mlx5dv_ts_to_ns(3) in order to translate the completion time- 
stamp from HCA core clock to nanoseconds. 

If the clock_info becomes too old then time conversion will return wrong conversion results. The user must 
ensure that mlx5dv_get_clock_info(3) is called at least once every max_clock_info_update_nsec as re¬ 
turned by the mlx5dv_query_device(3) function. 

RETURN VALUE 

0 on success or the value of errno on failure (which indicates the failure reason). 

SEE ALSO 

mlx5dv(7), mlx5dv_ts_to_ns(3) 

AUTHORS 

Feras Daoud <ferasda@mellanox.com> 


1 . 0.0 


2017-11-08 


1 



